package com.lxx.jmb2c.controller;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.lxx.jmb2c.common.PageResult;
import com.lxx.jmb2c.common.Result;
import com.lxx.jmb2c.dto.MemberPageQueryDTO;
import com.lxx.jmb2c.dto.*;
import com.lxx.jmb2c.entity.Member;
import com.lxx.jmb2c.service.MemberService;
import com.lxx.jmb2c.vo.MemberPageVO;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * 会员管理控制器
 * 
 * 这个控制器处理所有与会员相关的HTTP请求，包括：
 * 1. 批量删除会员
 * 2. 分页查询会员信息
 * 
 * 技术要点：
 * - 使用MyBatis Plus实现分页查询
 * - 使用Redis进行缓存(预留)
 * - 统一返回Result格式
 * 
 * 初学者需要了解：
 * - @RestController 表示这是一个控制器，会自动将返回对象转为JSON
 * - @RequestMapping 定义了基础路径为"/member"
 * - @Resource 和 @Autowired 都是依赖注入注解
 * 
 * Knife4j文档说明：
 * 访问 http://localhost:8080/doc.html 可以查看接口文档
 * 
 * @author lxx
 * @since 2025-07-02
 */
@Tag(name = "会员管理", description = "会员信息管理接口")
@Slf4j
@RestController
@RequestMapping("/member")
public class MemberController {

    @Resource
    private MemberService memberService;

    /**
     * StringRedisTemplate是RedisTemplate的子类，专门处理String类型数据
     * 使用场景：
     * - 缓存会员信息
     * - 存储会话token
     * - 实现分布式锁
     */
    @Autowired
    private StringRedisTemplate redisTemplate;

    /**
     * 批量删除会员
     * 
     * @param ids 要删除的会员ID列表
     * @return 操作结果
     * 
     * 初学者提示：
     * - @RequestBody 表示从请求体获取JSON数据
     * - removeBatchByIds是MyBatis Plus提供的批量删除方法
     * - 实际项目中应该添加权限验证
     */
    @Operation(summary = "批量删除会员", description = "根据ID列表批量删除会员信息")
    @DeleteMapping()
    public Result<Object> delete(
            @Parameter(description = "会员ID列表", required = true)
            @RequestBody List<Long> ids) {
        this.memberService.removeBatchByIds(ids);
        return Result.success();
    }

    /**
     * 分页查询会员信息
     * 
     * @param memberPageQueryDTO 分页查询参数
     * @return 分页结果
     * 
     * 技术细节：
     * - IPage是MyBatis Plus的分页结果对象
     * - 包含当前页数据、总记录数、总页数等信息
     * 
     * 初学者提示：
     * - 分页查询通常需要参数：当前页码、每页大小、排序字段等
     * - 前端可以通过修改参数实现翻页和排序
     */
    /**
     * 分页查询会员信息
     * 
     * @param memberPageQueryDTO 分页查询参数
     * @return 分页结果
     * 
     * 技术细节：
     * - IPage是MyBatis Plus的分页结果对象
     * - 包含当前页数据、总记录数、总页数等信息
     * - 通过URL参数接收分页和查询条件，如：/member/page?current=1&pageSize=20
     * 
     * 初学者提示：
     * - 分页查询通常需要参数：当前页码、每页大小、排序字段等
     * - 前端可以通过修改参数实现翻页、排序和条件筛选
     * - @ModelAttribute注解用于将URL查询参数绑定到对象
     */
    @Operation(summary = "分页查询会员", description = "根据条件分页查询会员信息")
    @GetMapping("page")
    public PageResult<MemberPageVO> page(
            @Parameter(description = "分页查询参数", required = true)
            @ModelAttribute MemberPageQueryDTO memberPageQueryDTO) {
        IPage<MemberPageVO> page = this.memberService.getPage(memberPageQueryDTO);
        return PageResult.success(page);
    }

    @GetMapping("{id}")
    public Result<Member> get(@PathVariable Long id) {
        Member member = this.memberService.getById(id);
        return Result.success(member);
    }

    @Operation(summary = "编辑会员信息", description = "根据ID编辑会员信息")
    @PutMapping("")
    public Result<Object> update(@RequestBody Member member) {
        this.memberService.updateById(member);
        return Result.success();
    }

    @Operation(summary = "重置密码",description = "重置会员密码")
    @PutMapping("resetPassword/{id}")
    public Result<Object> resetPassword(@PathVariable Long id){
        this.memberService.resetPassword(id);
        return Result.success();
    }

    // todo 0709 完成启用禁用会员接口
    @Operation(summary = "启用禁用会员", description = "根据ID启用或禁用会员")
    @PutMapping("enable/{id}")
    public Result<Object> enable(@PathVariable Long id) {
        this.memberService.enable(id);
        return Result.success();
    }
}
